package org.dromara.system.mapper;

import org.apache.ibatis.annotations.Param;
import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
import org.dromara.system.domain.SysFaultInfo;
import org.dromara.system.domain.vo.SysFaultInfoVo;

import java.util.List;

/**
 * 故障信息Mapper接口
 *
 * @author system
 */
public interface SysFaultInfoMapper extends BaseMapperPlus<SysFaultInfo, SysFaultInfoVo> {

    /**
     * 根据条件查询故障信息列表（包含关联的文档信息）
     *
     * @param excavatorModel 挖掘机机型
     * @param faultPart     故障部分
     * @param faultSymptom  故障现象
     * @param faultDetail       故障详情
     * @return 故障信息列表
     */
    List<SysFaultInfoVo> selectFaultInfoWithDocList(
        @Param("excavatorModel") String excavatorModel,
        @Param("faultPart") String faultPart,
        @Param("faultSymptom") String faultSymptom,
        @Param("faultDetail") String faultDetail
    );

    /**
     * 获取所有挖掘机机型列表
     *
     * @return 机型列表
     */
    List<String> selectDistinctExcavatorModels();

    /**
     * 根据机型获取故障部分列表
     *
     * @param excavatorModel 挖掘机机型
     * @return 故障部分列表
     */
    List<String> selectDistinctFaultParts(@Param("excavatorModel") String excavatorModel);

    /**
     * 根据机型和故障部分获取故障现象列表
     *
     * @param excavatorModel 挖掘机机型
     * @param faultPart     故障部分
     * @return 故障现象列表
     */
    List<String> selectDistinctFaultSymptoms(
        @Param("excavatorModel") String excavatorModel,
        @Param("faultPart") String faultPart
    );

    /**
     * 根据故障ID查询故障信息详情（包含关联的文档信息）
     *
     * @param faultId 故障ID
     * @return 故障信息详情
     */
    SysFaultInfoVo selectFaultInfoWithDocById(@Param("faultId") Long faultId);

    /**
     * 统计被指定解决方案引用的故障数量
     *
     * @param solutionId 解决方案ID
     * @return 引用数量
     */
    int countBySolutionId(@Param("solutionId") Long solutionId);
}
